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Dear Sir: 



Prior to examination of the above -referenced U.S. patent 
application, please amend the application as follows: 



IN THE SPECIFICATION; 

Amendments to the specification are set forth below. For the 
Examiner's convenience, and in compliance with 37 C.F.R. §1.121, 
the changes made to the specification are set forth on a separate 
sheet submitted herewith. 

Please amend page 12, last paragraph, lines 21 to 31 and page 
13, first two lines as follows: 
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A RegistryType interface 305, UserRegistry interface 32 0, 
PreferenceRegistry interface 325, ApplicationRegistry interface 
330, and EventObject class 335 are also provided. The Registry 
object serves as a generic mechanism for registering similar types 
of objects in the registry. That is, users are registered in a 
UserRegistry, and user preferences are registered in a 
PreferenceRegistry, as discussed in commonly-assigned Patent 
Application No. PCT/US99/23346, filed October 7, 1999 and entitled 
"Digital Television Receiver with Application Programming 
Interface For User Management . " 

Please amend page 13, first full paragraph, lines 3 to 7, as 
follows : 

Applications are registered in an ApplicationRegistry, 
discussed in commonly- as signed Patent Application No. 
PCT/US99/23721, filed October 7, 1999, and entitled "Software 
Application Lifecycle And Management For Broadcast Applications.' 7 

REMARKS 

This Preliminary Amendment amends the specification to add 
the missing application numbers on pages 12 and 13, and to 
indicate the amended title in application PCT/US99/23346 . 
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Entry of this Amendment prior to examination is respectfully 
requested. 
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Version with Markings to Show Changes Made; 

Page 12, lines 21-31 and page 13, lines 1-2: 

A RegistryType interface 305, UserRegistry interface 320, 
Pref erenceRegistry interface 325, ApplicationRegistry interface 
330, and EventObject class 335 are also provided. The Registry 
object serves as a generic mechanism for registering similar types 
of objects in the registry. That is, users are registered in a 
UserRegistry, and user preferences are registered in a 
Pref erenceRegistry, as discussed in commonly-assigned [PCT] Patent 

Application Mo. [ ,] PCT/US99/23346 . filed October 7, 

1999 and entitled ["Digital Television Receiver User Management 
Application Programming Interface (API) For Downloadable Broadcast 
Applications . " ] "Digital Television Receiver with Application 
Programming Interface For User Management.'' 

Page 13, lines 3-7: 

Applications are registered in an ApplicationRegistry, 
discussed in commonly-assigned [PCT] Patent Application No. 

[ ] PCT/US99/23721 , filed October 7, 1999, and 

entitled "Software Application Lifecycle And Management For 
Broadcast Applications." 
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APPLICATION PROGRAMMING INTERF ACE (API) FOR AC CESSSHGL- 
ANEL-MAS&fiING RESOURCES I N A DIGIT AL TELEVISION RECEIVER - 

BACKGROUND OF THE INVENTION 

This application claims the benefit of U.S. 
5 Provisional Application No. 60/107,962, filed November 

12, 1998. 

The present invention relates to an application 
programming interface (API) that provides a uniform 
mechanism for gaining/controlling access to resources, 

10 managing multiple resources of the same type, and 

accessing the individual resource's management state 
and status. The invention is suitable for use in 
managing resources in a Digital Television (DTV) 
Receiver/Terminal . 

15 A set- top terminal, also referred to as an 

Integrated Receiver-Decoder (IRD) or a subscriber 
terminal, is a device that receives and decodes 
television signals for presentation by a television. 
The signals can be delivered over a satellite, through 

20 a cable plant, or by means of terrestrial broadcast, 

for example. Various applications have been proposed, 
or are currently available, via modern set tops, 
including video on demand (VOD) , audio on demand, pay- 
per-view, interactive shopping, electronic commerce, 

25 electronic program guides, Internet browsers, mail 

services (e.g., text e-mail, voice mail, audio mail, 
and/or video mail) , telephony services, stock ticker, 
weather data, travel information, games, gambling, 
banking, shopping, voting, and others. Applications 

30 may also enable Internet connectivity and possibly 
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Internet -based telephony. The set top functionality is 
enabled through specialized hardware and software. 

The applications may be downloaded by terminals 
via a network, loaded locally (e.g., via a smart card), 
5 or installed at the time of manufacture, for example. 

Moreover, with the increasing integration of 
computer networks such as the Internet, telephony 
networks, and broadband distribution networks, many 
opportunities arise for providing new types of 
10 applications. 

However, in the new paradigm of broadcasting 
downloadable applications to television receivers, 
there is no deterministic way of predicting which 
applications will be running at what time, and possibly 
15 in parallel with other applications. Nonetheless, such 

applications must co-exist on the receiver and co- 
operate in such a manner that the end user has a 
positive experience while these applications compete 
for resources. For example, the applications should 

2 0 run without noticeable delays or interruptions. 

Also, since there are only limited resources on 
the terminal, there is a need to monitor and control 
these resources, either locally or remotely from a 
head-end or an uplink. Such a monitoring and control 
25 mechanism should provide improved control of the 

receivers in the network, and should also have the 
capability to prevent or fix problems related to 
resources on the receiver. 

It would be desirable to provide a mechanism for 

3 0 accessing and managing resources that addresses the 
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above issues. Preferably, the mechanism should be 
implement able in an API. 

The API should be compatible with Java(tm), 
ActiveX (tm) or an equivalent type of component based 
5 object-oriented technology. 

The API should be compatible with Digital Audio 
Visual Council (DAVIC) , American Television Standards 
Committee (ATSC) T3/S17 Digital TV Application Software 
Environment (DASE) , Digital Video Broadcast (DVB) - 
10 Multi-Media Home Platform (MHP) , and other related 
environments . 

The system should be compatible with the ITU-T 
X.731 standard for state management. 

The present invention provides a system having the 
15 above and other advantages. 
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SUMMARY OF THE INVENTION 

The present invention provides an application 
programming interface (API) for a television terminal 
that provides a uniform mechanism for 
5 gaining/controlling access to resources, managing 

multiple resources of the same type, and accessing the 
individual resource's management state and status. 

The terminal may be a DTV receiver, set -top box, 
IRD, TV-enabled PC, or the like. An application may 
10 use a resource, which is usually a device, function or 

a process on the receiver (e.g., tuner, modem, 
database, plug- in module, cable, software module, 
network interface card, persistent storage, TV screen 
space, memory, CPU, conditional access (CA) module, 
15 etc.) 

Moreover, individual resources may advertise 
changes in their state and status according to their 
capabilities and complexity. Applications which are 
using these resources may monitor the state and status 

2 0 changes and adjust their own behavior accordingly. 

Management applications, whose purpose is to monitor 
the behavior of resources to collect statistics, fine- 
tune the receiver configuration and/or detect and fix 
or prevent problems (e.g., resource conflicts, 

25 malfunctions, etc.) The management applications may be 

downloaded or otherwise provided (e.g., locally via a 
smart card or at the time of manufacture or 
installation) to all or selected receivers to perform 
such functions using this API. 
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The API includes three packages: resource, 
management and registry. The resource package depends 
on the registry and management packages . 

The API is preferably independent of an operating 
5 system and hardware of the terminal . 

In a particular implementation, a television set- 
top terminal is provided that includes a computer 
readable medium having computer program code means, and 
means for executing the computer program code means to 
10 implement an Application Programming Interface (API) 

for accessing and managing multiple resources at the 
terminal . The API provides a resource package for 
registering the available resources at the terminal, a 
resource state management package for managing states 
15 of the resources, and a registry package for storing 

objects that represent the resources. 

The resource objects, in this context, are 
software objects as known from the field of object- 
oriented technology. The objects represent the real 

2 0 resources at the terminal. A ResourceRegistry is a 

convenient place where an application can learn what 
types of resources are available, and retrieve a 
ResourceType Manager for a specific type of resource. 
Additionally, an application can determine how many, 
25 and which, resources are available, and possibly 

access/use one or more of the available resources. 

The management package may manage the states of 
the resources according to the ITU-T X.731 standard for 
state management . 

3 0 The available resources may include a tuner, a 

modem, a database, a plug- in module, a cable, a 
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software module, a network interface card, and a 
conditional access module, for example. 

The API may provide a resource registry for 
maintaining a record of resource managers that provide 
5 access to individual resources. 

The API may be independent of an operating system 
and hardware of the terminal. 

The API may group resources of the same type, and 
manage the grouped resources as a group. 
10 The API may monitor behavior of the resources, and 

attach (e.g., associate) corresponding management 
information to the resources . 

The API may enable the resources to advertise 
their respective states to at least one application at 
15 the terminal. The API may also enable the application 

to access the advertised states of the advertising 
resources . 

The API may enable administrative locking and 
unlocking of the resources . 
2 0 The API may enables the resources to advertise 

respective alarm statuses, availability statuses, 
procedural statuses, operational states, administrative 
states, and usage states thereof to applications at the 
terminal . 

2 5 A corresponding method is also presented. 
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BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 shows package relationships and 
dependencies in accordance with the present invention. 
FIG. 2 illustrates a resource package 
5 class/interface diagram in accordance with the present 

invention. 

FIG. 3 illustrates a management package 
class/interface diagram in accordance with the present 
invention. 

10 FIG. 4 illustrates a registry package 

class/interface diagram in accordance with the present 
invention. 

FIG. 5 illustrates an example class/interface 
diagram that shows how the resource, management and 
15 registry packages may be used with a network interface 

(tuner) in accordance with the present invention. 
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DETAILED DESCRIPTION OF THE INVENTION 
1. Introduction 

The present invention relates to an application 
programming interface (API) that provides a uniform 
5 mechanism for gaining access to resources 

(ResourceRegistry) , managing multiple resources of the 
same type (ResourceTypeManager) and accessing the 
individual resource's management state and status 
(GenericResource and ObjectState) . 

10 For example, downloadable applications (e.g., 

Electronic Program Guide - EPG, stock ticker, etc.) may 
need to access these resources. 

The invention describes a Resource Management API 
and its relationships to other related packages, 

15 specifically the Registry package, and how it can be 

applied to existing resources such as the Digital Audio 
Video Council (DAVIC) tuning resource 
(Networklnterf ace) . 

Note that portions of the disclosure were 

20 generated automatically from Rational Rose(tm) CASE 

tool, developed by Rational Software Corporation, USA. 
The figures use the Rational Rose (tm) depiction of the 
Unified Modeling Language (UML) , which is a language 
for specifying, constructing, visualizing, and 

25 documenting the artifacts of a software- intensive 

system. A class diagram represents the static 
structure of a system, and shows a pattern of behaviors 
that the system exhibits. This is accomplished by 
showing the existence of classes and their 

3 0 relationships. Each class is represented by a box with 
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three sections. The top section lists the class name. 
The middle section denotes a list of attributes, and 
the bottom section denotes a list of operations. 

A solid or dashed line between classes denotes an 
5 association or dependency. A white diamond tip denotes 

aggregation by reference, while a black diamond tip 
denotes aggregation by value. A triangular arrowhead 
denotes a restricted navigation, e.g., inheritance of 
operation but not of structure. 
10 Moreover, interfaces and classes begin with an 

uppercase letter, while methods begin with a lowercase 
letter. 

A class is a template that defines a data 
structure, method and function calls for an object. An 
15 interface defines a set of methods/function calls that 

can be manipulated by a class. The class provides the 
code for implementing an interface. 

2 . Model Description 

FIG. 1 shows package relationships and 
20 dependencies in accordance with the present invention. 

The API includes three packages: resource 40, 
management 30 and registry 20. The resource package 
depends on the registry and management packages. 

2.1 Resource Package 

25 FIG. 2 illustrates a resource package 

class/interface diagram in accordance with the present 
invention. The object diagram describes the resource 
management API of the present invention. A 
ResourceRegistry 100 is the central registry of all 



10 



available resources. The ResourceRegistry is the 
single place where a downloaded application must go to 
learn about existing resources. 

Resources of the same type are managed by a 
ResourceTypeManager 120. The DAV1C 
Networklnterf aceManager is an example of a 
ResourceTypeManager since there may be more than one 
Networklnterf ace in the DTV receiver. Individual 
resources implement the GenericResource interface 140, 
which identifies the name and type of the specific 
resource and, in turn, implements the ObjectStates 
interface 13 0 providing access to all or an appropriate 
subset of resource states and status information. 

A state is accessed to learn the current value of 
the state. 

The Event -Listener model provides a mechanism to 
inform listeners about changes in the ResourceRegistry 
100, such as addition of new resources or their removal 
from the registry. 

As is known, Java defines an Event-Listener 
pattern which allows objects to register as listeners 
to another object. If there are any changes with this 
object, it sends an event to the listening object. 

A ResourceType interface 110, RegistryChangeEvent 
class 150, ResourceChangeCause interface 160, and 
ResourceRegistry Event class 170 are also provided. 

Exceptions 180 can also be defined. Specifically, 
the structure is set up so that security can be used to 
allow some applications to access resources and some 
other not. If this is desirable, it may be done 
implicitly (already built into Java) , or explicitly by 
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defining new Exceptions. 

2.2 Management Package 

FIG* 3 illustrates a management package 
class/interface diagram in accordance with the present 
invention. The diagram describes those classes and 
interfaces related to state management, specifically 
managing resource states based on the ITU-T management 
standard. It is separated into its own package since 
it can be applied to any manageable object, such as DTV 
receiver resources, downloadable applications, etc. 

The management package includes an 
AdministrativeState interface 205, an OperationalState 
interface 210, a UsageState interface 215, an 
AlarmStatus interface 225, an AvailabilityStatus 
interface 230, a ProceduralStatus interface 235, an 
Exception class 240, a ResourceStateException class 
245, a StateChangeListener interface 250, an 
EventObject class 255, a Sourcelndicator interface 260, 
and a StateChangeEvent class 265. 

A specific resource is free to support a subset of 
the defined states and status attributes as appropriate 
to the specific resource functionality. DigitalTV 
Application Software Environment (DASE) may mandate a 
subset of these in order to provide for a better 
interoperability between applications and resources 
with respect to management . 

2.3 Registry Package 
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FIG. 4 illustrates a registry package 
class/interface diagram in accordance with the present 
invention. 

The Registry package provides a basic mechanism to 
5 construct a Registry object of any kind. The Registry 

is a base interface which is extended by all specific 
Registries, such as the ResourceRegistry 100. 

There is a RegistryListener 345 and 
RegistryChangeEvent 150 associated with this package. 

10 The listener interface 345 is used by any object that 

wants to be notified of any changes in the Registry 
310. Changes are considered those that affect the 
Registry itself (not necessarily the individual 
elements in the registry) , such as adding or removing 

15 elements to/from the Registry 310. The 

RegistryChangeEvent 150 is an abstract class which will 
be extended by the specific registry events. 

Since most of the API is defined in terms of Java 
Interfaces, the RegistryFactory 315 is a class that 

2 0 hides the actual object construction implementation. 

A RegistryType interface 3 05, UserRegistry 
interface 32 0, Pref erenceRegistry interface 325, 
ApplicationRegistry interface 330, and EventObject 
class 335 are also provided. The Registry object serves 

25 as a generic mechanism for registering similar types 

of objects in the registry. That is, users are 
registered in a UserRegistry, and user preferences are 
registered in a Pref erenceRegistry, as discussed in 
commonly- as signed PCT Patent Application No. 

30 , filed October 7, 1999, and entitled 

"Digital Television Receiver User Management 
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Application Programming Interface (API) For 
Downloadable Broadcast Applications." 

Applications are registered in an 
ApplicationRegistry, discussed in commonly-assigned PCT 

5 Patent Application No. , filed October 7 , 

1999, and entitled "Software Application Lifecycle And 
Management For Broadcast Applications." 

2 . 4 Tuning Package 

FIG. 5 illustrates an example class/interface 
10 diagram that shows how the resource, management and 

registry packages may be used with a network interface 
(tuner) in accordance with the present invention. The 
diagram shows how the Resource package classes can be 
applied to already defined resources. Generally, the 
15 figure is an example of how the resource, management 

and registry packages may be used. 

This example shows the DAVIC tuning API 
(org.davic.net .tuning) where the 

NetworklnterfaceManager 42 0, which manages multiple 
20 Networklnterfaces 430, can be considered as the generic 

ResourceTypeManager 120. Classes 420 and 430 are from 
the DAVIC tuning package. The Networklnterf ace 430, 
which represents the specific resource, can implement 
the GenericResource interface 140 and, in turn, the 
25 ObjectStates interface 130. 

A ResourceServer interface 410 is also provided. 
A ResourceServer is another interface from the DAVIC 
set of packages. This example shows how the present 
invention can be applied to an existing resource that 
3 0 is defined by another organization - DAVIC, in this 
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case. 

3. Class and Interface Specification 

The following sections describe the individual 
classes, interfaces and their methods. 

3 . 1 Resource Package 

This package provides classes and interfaces 
related to resource management functions. 

3.1.1 ResourceRegistry 

This interface 100 defines the necessary 
functionality behind the ResourceRegistry as applicable 
to an application. It lists resources. For example, a 
downloadable application may ask the ResourceRegistry 
what types of resources are available on the terminal, 
and then get the ResourceTypeManager to request access 
to a specific resource. ResourceRegistry 100 is 
derived from ResourceType 110 and Registry 310. 

Public Operations: 

getResourceTypeManager (resourceType : short) : 
ResourceTypeManager 

Returns a Resource Type Manager which manages a 
collection of resources of the specified type. Returns 
Null if this type of a resource does not exist. 

getResourceTypes () : short [] 

This method returns a list of supported resource 
types . 

Public operations are those methods that may be 
called and used by other objects since they are visible 
outside of the object (e.g., class). In contrast, 
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private operations are visible only to the 
class/ interface itself . 

3.1.2 ResourceTypeManager 

This interface 120 has to be supported by classes 
5 representing managers of a certain type of a resource. 
It is expected that most ResourceServers from the 
org. davic. resources package will implement this 
interface. It is derived from ResourceType 110. 
Public Operations: 
10 getResources () : GenericResource [] 

Returns a list of GenericResources managed by this 
ResourceTypeManager . 

getAvailableCount () : int 

Returns the number of available resources . 
15 getTotalCount () : int 

Returns the total number of resources managed by 
this ResourceTypeManager. 
getType () : short 

Returns the type of this resource manager. 

20 3.1.3 GenericResource 

This interface 140 represents a Generic Resource 
which defines a common interface that has to be 
implemented by every manageable resource. 

Only an applicable subset of ObjectStates 130 will 
25 be implemented by each specific resource. 

The class that represents the actual resource 
(such as the Networklnterf ace 43 0) or a proxy (such as 
the DAVIC ResourceProxy) may implement this interface. 
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It is derived from ObjectStates 13 0 and 
ResourceType 110 . 

Public Operations: 

getType ( ) : short 

Returns the type of this resource. 

getName () : String 

Returns a name of this resource. 

3.1.4 ResourceType 

This interface defines the different types of 
resources; such as a network interface card, 
conditional access (CA) module, modem, etc. 

Public Attributes: 

NETWORK_INTERFACE : String = "Network Interface" 
CA_MODULE : String = "Conditional Access Module" 
MODEM : java. lang. String = "Telco Modem" 
SECTION_FILTER : String = "MPEG Section Filter" 

3.1.5 ResourceRegistryEvent 

This event 170 informs the RegistryListener 345 
that there was a change in the Registry 310. The Event 
has information about the type of a resource that 
changed, and the nature of the change (e.g., resource 
added, removed, etc.). 

It may be useful in some implementations to return 
the ResourceTypeManager 120 of the affected resource. 

It is derived from Regis try ChangeEvent 150. 

Public Operations: 

getResourceType () : java. lang* String 

Returns the type of resource that has changed in 
the ResourceRegistry 100. 
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3.1.6 ResourceChangeCause 

This interface defines possible causes for the 
ResourceRegistryEvent 170 . 
Public Attributes: 
5 RESOURCE_ADDED : short = 1 

RE S 0URCE_REM0 VED : short 

3 . 2 Management Package 

This package includes classes and interfaces 
related to object management. It can be applied in its 
10 entirety or as a subset as relevant to the specific 

managed entity. It is applicable for managing state 
and status attributes of digital television (DTV) 
receiver resources as well as applications. 

It is based on the ITU-T X.731 standard for State 
15 Management. 

3.2.1 AdministrativeState 

An interface that defines Masks for different 
Administrative States: 

-locked: The resource is administratively 
20 prohibited from performing services for its users. 

-Unlocked: The resource is administratively 
permitted to perform the services to users. 

The unlocked state is independent of its inherent 
operability. That is, a resource may be locked or 
25 unlocked (the Administrative State) and enabled or 

disabled (the Operational State) - these are 
independent of each other. 
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-Shutting down: Use of resource is 
administratively permitted to the existing instances of 
users only. The manager may at any time cause the 
object to revert to the Unlocked state. 
5 Public Attributes: 

UNLOCKED : int = 0x00000001 

LOCKED : int = 0x00000002 

SHUTTINGJDOWN : int = 0x00000004 

ADMIN_TYPE : short = 1 
10 Public Operations: 

getAdministrativeState () : int 

Called to get the current value of the 
Administrative State . 

setLock (administrativeState : int) : void 
15 Called to change the value of the Administrative 

State. 



3.2.2 OperationalState 

This interface 210 defines the Operational state 
for Resources and Application. Note that this 

2 0 Management API is a generic mechanism that allows any 

resource or any application to implement the 
ObjectStates interface to support manageability. In a 
specific case (e.g., FIG. 5) a Networklnterf ace 
implements the GenericResource interface 140, which in 

25 turn implements the ObjectStates interface 13 0, which 

has all the methods necessary for a resource to be 
managed . 

-Disabled: The resource is totally inoperable and 
unable to provide the service to the users . 



-Enabled: The resource is partially operable and 
available for use. 

Public Attributes: 

DISABLED : int = 0x8 

ENABLED : int = 0x10 

OPERATIONAL_TYPE : short = 2 

Public Operations: 

getOperationalState () : int 

Called to get the current value of the 
OperationalState 210. 

3.2.3 AlarmStatus 

This interface 225 defines all the alarm states. 

When the value of this attribute is an empty set, 
this implies that none of the status conditions 
described below are present. 

-under repair: The resource is currently being 
repaired. When under repair value is present, the 
operational state is either disabled or enabled. 

-critical: One or more critical alarms indicating 
a fault have been detected in the resource, and have 
not been cleared. The operational state of the managed 
object can be disabled or enabled. 

-major: One or more major alarms indicating a 
fault have been detected in the resource, and have not 
yet been cleared. The operational state of the managed 
object can be disabled or enabled. 

-minor: One or more minor alarms indicating a 
fault have been detected in the resource, and have not 
yet been cleared. The operational state of the managed 
object can be disabled or enabled. 
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-alarm outstanding: One or more alarms have been 
detected in the resource. The condition may or may not 
be disabling. If the operational state is enabled, 
additional attributes, particular to the managed object 
5 class, may indicate the nature and cause of the 

condition and the services that are affected* 

The presence of the above alarm state conditions 
does not suppress the generation of future fault - 
related notifications. 
10 Public Attributes: 

UNDER_REPAIR : int = 0x00000001 
CRITICAL : int = 0x00000002 
MAJOR : int = 0x00000004 
MINOR : int = 0x00000008 
15 AL ARM_OUT S TAND ING : int = 0x0010 

ALARM_TYPE : short = 8 
Public Operations: 
clearAlarm (alarm : int) : void 

Called to clear a specific alarm. The controlling 
20 process has acted on the alarm. 

getAlarmStatus () : int 

Called to get the current set of values of the 
Alarm Status . 



3.2.4 AvailabilityStatus 

25 This interface 23 0 defines the Availability status 

of a resource. 

When the value of this attribute is an empty set, 
this implies that none of the status conditions 
described below are present . 
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-in test: The resource is undergoing a test 
procedure. If the administrative state is locked or 
shutting down then normal users are precluded from 
using the resource and the control status attribute has 
5 the value reserved for test. 

Tests that do not exclude additional users can be 
present in any operational or administrative state but 
the reserved for test condition should not be present . 

-failed: The resource has an internal fault that 
10 prevents it from operating. The operational state is 

disabled, 

-power off : The resource requires power to be 
applied and is not powered on. 

For example, a fuse or other protection device is 
15 known to have removed power or a low voltage condition 

has been detected. The operational state is disabled. 

-off line: The resource requires a routine 
operation to be performed to place it online and make 
it available for use. The operation may be manual or 
20 automatic, or both. 

The operational state is disabled, 
-off duty: The resource has been made inactive by 
an internal control process in accordance with a 
predetermined time schedule. Under normal conditions 
25 the control process can be expected to reactivate the 

resource at some scheduled time, and it is therefore 
considered to be optional. The operational state is 
enabled or disabled. 

-dependency: The resource cannot operate because 
30 some other resource on which it depends (e.g., a 
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resource not represented by the same managed object) is 
unavailable . 

For example, a device is not accessible because 
its controller is powered off. 
5 The operational state is disabled. 

-degraded: The service available from the resource 
is degraded in some respect, such as in speed or 
operating capacity. Failure of a test or an 
unacceptable performance measurement has established 
10 that some or all services are not functional or are 

degraded due to the presence of a defect. However, the 
resource remains available for service, either because 
some services are satisfactory or because degraded 
service is preferable to no service at all. Object 
15 specific attributes may be defined to represent further 
information indicating, for example, which services are 
not functional and the nature of the degradation. The 
operational state is enabled. 

-not installed: The resource represented by the 
20 managed object is not present, or is incomplete. For 

example, a plug- in module is missing, a cable is 
disconnected or a software module is not loaded. The 
operational state is disabled. 

-log full: This indicates a log full condition, 
25 the semantics of which are defined in CCITT Rec. X.73 5 

| ISO/IEC 10164-6. 

Public Attributes: 
INTEST : int = 0x00000400 
FAILED : int - 0x00000800 
3 0 POWEROFF : int = 0x00001000 

OFFLINE : int = 0x00002000 
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OFFDUTY : int = 0x00004000 
DEPENDENCY : int = 0x00008000 
DEGRADED : int = 0x00010000 
NOTJENSTALLED : int = 0x00020000 
5 LOG_FULL : int = 0x00040000 

AVAILABILITYJTYPE : short =32 
Public Operations: 
getAvailabilityStatus () : int 
Called to get the current set of values of the 
10 AvailabilityStatus 230. 

3.2.5 ProceduralStatus 

This interface 235 defines the Procedural status. 
The procedural status attribute is supported only 
by those classes of managed objects that represent some 

15 procedure (e.g., a test process) which progresses 

through a sequence of phases . Depending upon the 
managed object class definition, the procedure may be 
required to reach certain phase for the resource to be 
operational and available for use (i.e., for the 

20 managed object to be enabled) . Not all phases may be 

applicable to every class of managed object. If the 
value of this attribute is an empty set, the managed 
object is ready, for example, the initialization is 
complete . 

25 When the value of this attribute is an empty set, 

this implies that none of the status conditions 
described below are present . 

-initialization required: The resource requires 
initialization to be invoked by the manager (e.g., 

3 0 ResourceTypeManager 120) before it can perform its 



24 



normal functions, and this procedure has not been 
initiated. The manager may be able to invoke such 
initialization through an action. The terminating 
condition may also be present. The operational state 
5 is disabled. 

-not initialized: The resource requires 
initialization before it can perform its normal 
functions, and this procedure has not been initiated. 
The resource initializes itself autonomously, but the 

10 operational state may be either disabled or enabled, 
depending upon the managed object class definition. 

-initializing: The resource requires 
initialization before it can perform its normal 
functions, and this procedure has been initiated but is 

15 not yet complete. When this condition is present, the 
initialization required condition is absent, since 
initialization has already begun. The operational 
state may be disabled or enabled, depending upon the 
managed object class definition. 

20 -reporting: The resource has completed some 

processing operation and is notifying the results of 
the operation, e.g., a test process is sending its 
results. The operational state is enabled. 

-terminating: The resource is in a termination 

25 phase. If the resource does not reinitialize itself 

autonomously, the initialization required condition is 
also present and the operational state is disabled. 
Otherwise, the operational state may be either disabled 
or enabled, depending upon the managed object class 

30 definition. 

Public Attributes: 
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INIT_REQUIRED : int = 0x00000020 
NOT__INITIALIZED : int = 0x00000040 
INITIALIZING : int = 0x00000080 
REPORTING : int = 0x00000100 
5 TERMINATING : int = 0x00000200 

PROCEDURAL_TYPE : short = 16 
Public Operations: 
getProceduralStatus () : int 

Called to get the current set of values of the 
10 Procedural Status. 

3,2.6 UsageState 

This interface 215 defines the Mask (i.e., the bit 
assignment shown below for IDLE, ACTIVE, etc.) for 
UsageState, which is the name of the interface which 
15 represents the concept of Usage State from the ITU-T 

X.731 standard. 

-Idle: The resource is not currently in use. 
-Active: The resource is in use, but has spare 
operating capacity to provide additional users at this 
20 instant. 

-Busy: The resource is in use, but has no spare 
operating capacity to provide additional users at this 
instant . 

Public Attributes: 
25 IDLE : int = 0x00000020 

ACTIVE : int = 0x00000040 
BUSY : int = 0x00000080 
USAGE_TYPE : short = 4 
Public Operations: 
3 0 getUsageState () : int 
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Called to get the current value of the Usage 
State. 

3,2.7 Ob j ectStates 

This interface 13 0 allows objects, which are meant 
5 to be managed in a standard way, to implement a unified 

interface which supports all or a suitable subset of 
states and status values. The defined state and status 
attributes are specified by the ITU-T standard X.731 
for State Management. 
10 It is derived from AlarmStatus 225, 

ProceduralStatus 235, AvailabilityStatus 23 0, 
UsageState 215, OperationalState 210, and 
AdministrativeState 205. 
Public Operations: 
15 getStatesSupported () : short [] 

Called to determine which state and status 
attributes are supported by the class implementing this 
interface. 

addStateChangeListener (listener : 
20 StateChangeListener) : void 

Called to register a StateChangeListener for 
StateChangeEvents . 

removes tat eChangeLi s t ener ( 1 i s t ener : 
StateChangeListener) : void 
25 Called to deregister a StateChangeListener. 

getCurrentState () : int 

Called to get the current value of all supported 
states. Returns a bit mask representing the individual 
states . 

30 getCurrentStatus () : int 
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Called to get the current value of all supported 
status attributes. Returns a bit mask representing the 
individual status attributes. 



3.2.8 StateChangeListener 

5 This interface 250 must be implemented by classes 

interested in being notified of state changes of 
objects which implement the ObjectStates interface 13 0. 
If an object which is a StateChangeListener 250 
registers via the addStateChangeListener method, it 
10 will be notified by calling the stateChange method 

which includes the appropriate StateChangeEvent 265. 
Public Operations: 

stateChange (event : StateChangeEvent) : void 

Called to notify a StateChangeListener about a 
15 state change. The event parameter provides information 
about what state has changed. 

3.2.9 ResourceStateException 

A base Exception class 245 related to the 
ObjectStates 13 0 interface. This exception, or its 
20 extensions, are thrown when a invalid state change 

would be caused by a method call. For example, an 
object in a Disabled state cannot perform a certain 
operation unless it is Unlocked. Derived from the 
Exception class 240. 
25 Public Operations: 

getState () : short 

Called to determine which state consistency has 
been violated. 

getValue () : int 
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Called to get the current value of the violated 
state . 

3 . 2 . 10 StateChangeEvent 

This Event 265 is fired (e.g., emitted or sent) 
when a state changes its value. It is distributed to 
all registered StateChangeListeners 250* 

Derived from EventObject 255. 

Public Operations: 

getState () : short 

Called to determine which state has changed. 
getOldValue () : int 

Called to determine the original value of the 
state . 

getNewValue () : int 

Called to determine the new value of the state. 
getSourcelndicator () : short 

Called to determine the cause of the event. 

3 . 2 • 11 Sourcelndicator 

Public Attributes: 
INTERNAL_CAUSE : short = 1 

State change caused by an internal activity. 
EXTERNAL_CAUSE : short = 2 

State change caused by an external activity. 
3.3 Registry Package 

This package provides a set of supporting and 
utility classes and interfaces used by other packages. 



3.3.1 Registry 



This interface 310 provides a common root to all 
specialized registry interfaces, such 
ApplicationRegistry 330, ResourceRegistry 100, etc. 
(FIG. 4) . It is provided so that the Regis tryFactory 
315 can return a base type. 

A "base type" is known from the field of object- 
oriented programming. To illustrate, one can define a 
class with a set of functions (methods) and internal 
variables (e.g., a class "Fruit" which represents fruit 
and its basic characteristics) . One can specialize it 
by defining a new class, "Apple", which inherits 
everything from the class "Fruit", and adds new 
functions that are applicable only to Apples but not to 
Fruit in general. "Fruit" is then referred to as a 
"base class" or a "base type." 

Derived from RegistryType 305. 

Public Operations: 

getRegistryType () : String 

Called to determine the type of registry 
implemented by the object returned by the 
RegistryFactory ' s method getRegistry { ) . 

addRegistryListener (listener : 
org . atsc . registry . Regis tryListener) : void 

Called to register for events generated by the 
Registry 310. 

removeRegis tryListener (listener : 
org . atsc . registry • RegistryLis tener ) : void 

Called to deregister for events generated by the 
Registry 310. 



3 ♦ 3 . 2 Regi s t ryFac t ory 



This class 315 provides a mechanism to create 
objects that implement specific Registry interfaces, 
such as the ApplicationRegistry 330. This class is 
modeled after the Factory Method design pattern, which, 
as is known from the field of object-oriented 
programming, is a methodology and structure for solving 
a problem. 

Public Operations: 

RegistryFactory () : 

Constructor : 

getRegistry (registryName : String) : 
org . atsc . registry . Registry 

Returns an instance of an object which implements 
the specified registry interface. Returns null when 
specified registry does not exist or cannot be created. 
The type of the returned object will be one of the 
derived Registry types, such as the ApplicationRegistry 
330. 

As known from the field of object-oriented 
programming, a constructor is a method that is called 
for each object at the time it is created/ instantiated. 

3.3.3 RegistryType 

This interface 3 05 defines names for different 
registry types, such as an application registry (e.g., 
ApplicationRegistry 330), etc. 

Public Attributes : 

APPLICATION_REGISTRY : String = "Application 
Registry" 

RESOURCE_REGISTRY : String = "Resource Registry" 
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PREPERENCE_REGISTRY : String = "Preference 
Registry" 

US ER_REGI STRY : String = "User Registry" 

3.3,4 RegistryListener 

5 This interface 345 allows an object to listen to 

changes made to the Registry 310 . 
Public Operations: 

regis tryChange () : ApplicationRegistryEvent 

This method of all registered 
10 ApplicationRegistryListeners (e.g. , RegistryListener 
345) is called by the ApplicationRegistry object 33 0 
when an ApplicationRegistryEvent is fired. 

3 • 3 . 5 Regis tryChangeEvent 

This a generic registry change event 150 which is 
15 extended by all specific registries (such as 

ApplicationRegistry 33 0, etc.) to provide specific 
information about the change. It is derived from 
EventObject 335. 

Public Operations: 
20 getRegistryType () : java.lang, String 

Returns the type of a registry that this event is 
associated with. 

getCause () : short 

Returns the cause of the RegistryChangeEvent 150. 
25 Each derived event will define a set of causes 

appropriate for the registry it represents. 



Totals 

4 Logical Packages 
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23 Classes 

Accordingly, it can be seen that the present 
invention provides an application programming interface 
(API) for a television terminal that provides a uniform 
5 mechanism for gaining/controlling access to resources, 
managing multiple resources of the same type, and 
accessing the individual resource's management state 
and status as defined by the X.731 ITU-T standard. The 
invention is suitable for use in managing resources in 
10 a Digital Television (DTV) Receiver/Terminal. 

Although the invention has been described in 
connection with various specific embodiments, those 
skilled in the art will appreciate that numerous 
adaptations and modifications may be made thereto 
15 without departing from the spirit and scope of the 
invention as set forth in the claims. 

For example, while various syntax elements have 
been discussed herein, note that they are examples 
only, and any syntax may be used. 
20 Moreover, the invention is suitable for use with 

virtually any type of network, including cable or 
satellite television broadband communication networks, 
local area networks (LANs) , metropolitan area networks 
(MANs) , wide area networks (WANs), internets, 
25 intranets, and the Internet, or combinations thereof. 

Additionally, known computer hardware, firmware 
and/or software techniques may be used to implement the 
invention. 
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What is claimed is: 

1. A television set- top terminal, comprising: 

a computer readable medium having computer program 
code means; and 

means for executing said computer program code 
means to implement an Application Programming Interface 
(API) for accessing and managing multiple resources at 
the terminal, wherein: 

the API provides a resource package for 
registering the available resources at the terminal, a 
management package for managing states of the 
resources, and a registry package for storing objects 
that represent the resources. 

2. The terminal of claim 1, wherein: 

the management package manages the states of the 
resources according to an ITU-T X.731 standard for 
state management. 

3. The terminal of claim 1, wherein the 
available resources include at least one of: 

a tuner, a modem, a database, a plug- in module, a 
cable, a software module, a network interface card, and 
a conditional access module • 

4. The terminal of claim 1, wherein: 
the API provides a resource registry for 

maintaining a record of resource managers that provide 
access to individual resources. 



34 



5. The terminal of claim 1, wherein: 

the API is independent of an operating system and 
hardware of the terminal. 

6. The terminal of claim 1, wherein: 

the API groups resources of the same type, and 
manages the grouped resources as a group. 

7. The terminal of claim 1, wherein: 
the API monitors behavior of the resources, 

attaches corresponding management information to 
resources . 

8. The terminal of claim 1, wherein: 
said API enables the resources to advertise 

respective states to at least one application at 
terminal . 

9. The terminal of claim 8, wherein: 
said API enables the application to access the 

advertised states of the advertising resources. 

10. The terminal of claim 1, wherein: 
said API enables administrative locking and 

unlocking of the resources. 

11. The terminal of claim 1, wherein: 
said API enables the resources to advertise 

respective alarm statuses thereof to at least one 
application at the terminal. 
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12. The terminal of claim 1, wherein: 
said API enables the resources to advertise 

respective availability statuses thereof to at least 
one application at the terminal. 

13. The terminal of claim 1, wherein: 
said API enables the resources to advertise 

respective procedural statuses thereof to at least one 
application at the terminal. 

14. The terminal of claim 1, wherein: 
said API enables the resources to advertise 

respective operational states thereof to at least one 
application at the terminal. 

15. The terminal of claim 1, wherein: 
said API enables the resources to advertise 

respective administrative states thereof to at least 
one application at the terminal . 

16. The terminal of claim 1, wherein: 
said API enables the resources to advertise 

respective usage states thereof to at least one 
application at the terminal. 

17. The terminal of claim 1, wherein: 
the resources are used for downloadable 

applications at the terminal. 

18. The terminal of claim 1, wherein the 
applications include at least one of: 
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video on demand (VOD) , audio on demand, pay-per- 
view, interactive shopping, electronic commerce, 
electronic program guides, Internet browsers, mail 
services (e.g., text e-mail, voice mail, audio mail, 
and/or video mail) , telephony services, stock ticker, 
weather data, travel information, games, gambling, 
banking, shopping, and voting. 

19. The terminal of claim 1, wherein: 

the applications enable at least one of Internet 
connectivity and Internet -based telephony. 

20. A method for implementing a software 
architecture for a television set- top terminal, 
comprising the steps of : 

providing a computer readable medium having 
computer program code means ; and 

executing said computer program code means to 
implement an Application Programming Interface (API) 
for accessing and managing multiple resources at the 
terminal ,* wherein : 

the API provides a resource package for 
registering the available resources at the terminal, a 
management package for managing states of the 
resources, and a registry package for storing objects 
that represent the resources. 
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ABSTRACT 

An application programming interface (API) for 
managing resources in a Digital Television (DTV) 
Receiver /Terminal . The API provides a uniform 
5 mechanism for gaining/controlling access to resources, 
managing multiple resources of the same type, and 
accessing the individual resource's management state 
and status. The resources may include, for example, a 
tuner, a modem, a database, a plug- in module, a cable, 

10 a software module, a network interface card, or a 

conditional access module. The resources are monitored 
and controlled either locally at the terminal, or 
remotely, e.g., from a head-end or an uplink. The API 
provides a resource package (40) for registering the 

15 available resources at the terminal, a resource state 

management package (3 0) for managing states of the 
resources, and a registry package (20) for storing 
objects that represent the resources. Resources of the 
same type are managed as a group. 

G1C-561 ApnM 1,2001 
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DECLARATION, POWER OF ATTORNEY, AND PETITION 



Attorney Docket No.: GIC-561 
Page 1 of 3 

As a below named inventor, I hereby declare that: 

My residence, post office address and citizenship are as stated below next to my name. 

I believe I am the original, first and sole inventor (if only one name is listed below) or an original, first and joint inventor 
(if plural names are listed below) of the subject matter which is claimed and for which a patent is sought on the invention entitled 

APPLICATION PROGRAMMING INTERFACE (API) FOR ACCESSING AND MANAGING 
RESOURCES IN A DIGITAL TELEVISION RECEIVER 

the specification of which is attached hereto unless the following box is checked: 

'[ X ] was filed on October 7, 1999 as United States Application Number or PCT Inteniational Application 

■Number PCT/US99/23358 and was amended on September 22, 2000 (if applicable). 

I hereby state that I have reviewed and understand the contents of the above-identified specification, including the claims, 
as amended by any amendment referred to above. 

I acknowledge the duty to disclose to the U.S. Patent and Trademark Office all information known to be material to the 
patentability of this application in accordance with Title 37, Code of Federal Regulations, §1.56. 

I hereby claim foreign priority benefits under Title 35, United States Code, §119(a)-(d) or 365(b) of any foreign 
applications) for patent or inventor's certificate or 365(a) of any PCT international application which designated at least one 
country other than the United States of America, listed below and have also identified below any foreign application for patent or 
inventor's certificate or of any PCT international application having a filing date before that of the application on which priority is 
claimed: 

Priority Claimed 

(Number) (Country) Month/Day/Year Filed " Yes ^ No 

[ ] [ ] 

(Number) (Country) Month/Day/Year Filed Yes No 

I hereby claim the benefit under Title 35, United States Code, §119(e) of any United States provisional applications) 
listed below. 

60/107,962 November 12, 1998 



(Application Number) (Filing Date) - Month/Day/Year 



(Application Number) (Filing Date) - Month/Day/Year 

I hereby claim the benefit under 35 U.S.C. 120 of any United States applications), or 365(c) of any PCT international 
application designating the United States of America, listed below and, insofar as the subject matter of each of the claims of this 
application is not disclosed in the prior United States or PCT international application in the manner provided by the first paragraph 
of 35 U.S.C. 112, I acknowledge the duty to disclose information which is material to patentability as defined in 37 C.F.R. 1.56 
which became available between the filing date of the prior application and the national or PCT international filing date of this 
application. 



U.S. Parent Application 
or PCT Parent Number 



Parent Filing Date 
(MM/DD/YYYY) 



Parent Patent Number 
(if applicable) 



Attorney Docket No.: GIC-561 
Page 2 of 3 

And I hereby appoint: Barry R. Lipsitz, Registration N o, 28.637 and Douglas M. McAllister, Registration No. 
37, 886 ,, all of the firm o f Barry RJ ^msitz, Attorney at La w, 755 Main Street, Bldg. 8, Monroe, Connecticut 06468... 
Telephone (203) 459-0200, my attorneys with full power of substitution and revocation, to prosecute this application and to 
transact all business in the Patent and Trademark Office connected therewith. 

Wherefore I pray that Letters Patent be granted to me for the invention or discovery described and claimed in the 
foregoing specification and claims, and I hereby subscribe my name to the foregoing specification and claims, declaration, power 
of attorney, and this petition. 

I hereby declare that all statements made herein of my own knowledge are true and that all statements made on 
information and belief are believed to be true; and further that these statements were made with the knowledge that willful false 
statements and the like so made are punishable by fine or imprisonment, or both, under Section 1001 of Title 18 of the United 
States Code and that such willful false statements may jeopardize the validity of the application or any patent issued thereon. 

Full name of sole or first inventor: PetrPETE RKA 

' Inventor's Signature '^^^^ ^ Date: ^ 2 ^Q/ 



San Diego California <3 A USA 

Residence Citizenship: 

(City) (State or Foreign Country) 

5126 Caminito Vista Lujo San Diego, California 92130, U.S.A. 

Post Office Address 

(Post Office Address) (City) (State & Zip Code/Country) 



iSp^jjO Full name of second joto^inventoru ^ Branis^^ MEA|^OJA^ 

Id Inventor's Signature^ 



anventor^ y liramsij^v jy vi nAFiMMslA^ f / / 



La Jolla California ClsAr USA 

Residence Citizenship: 

(City) (State or Foreign Country) 

827 Coast Blvd South La Jolla, California 92037, U.S.A. 

Post Office Address 

(Post Office Address) (City) (State & Zip Code/Country) 



Full name of third joint inventor: Geetha M ANGALORE 

Inventor's Signature J^* QjU^lTy Date: j ^ l^oef 

^Sanjakgn . Californii/^ A INDIA 

Residence Citizenship: 

(City) (State or Foreign Country) 



11674 Spring Side Road San Diego, California 92128, U.S.A. 

Post Office Address 



(Post Office Address) (City) (State & Zip Code/Country) 
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Full name of fourth joint inventor: Kur t ZAISER 

Inventor's Signature_ Date: XZ<&^r<§^ 

San Diego v CaUfornia(3y|~' USA 

Residence * Citizenship: 

(City) (State or Foreign Country) 

9260 Clover Glen Court San Diego, California 92126, U.S.A. 

Post Office Address 

(Post Office Address) (City) (State & Zip Code/Country) 



